Pular para o conteúdo principal

Descrição das opções comuns

Este módulo está disponível somente a partir da versão 20260507.

Várias interfaces de ui_element aceitam uma tabela de opções para especificar o aplicativo de destino, a quantidade retornada, a profundidade de recursão, a verificação de acerto e o passo da rolagem.

Opções de consulta​

local options = {
pid = app.front_pid(),
max_level = 2,
max_elements = 200,
include_hit_state = true,
}
  • pid
    Inteiro; especifica o identificador do processo do aplicativo de destino. Quando omitido, normalmente usa o aplicativo em primeiro plano.
  • max_level
    Inteiro; profundidade de recursão dos elementos filhos. Use normalmente 1 ou 2 para controlar a quantidade de dados retornada.
  • max_elements
    Inteiro; quantidade máxima de elementos do nível superior retornados.
  • fallback_children
    Booleano; tenta ler os elementos filhos quando a lista comum está vazia. O padrão varia conforme a interface.
  • include_hit_state
    Booleano; indica se os campos do estado de acerto devem ser incluídos.
  • hit_test
    Booleano; indica se o acerto por amostragem da tela deve ser habilitado. Scripts comuns normalmente não precisam ativá-lo.
  • fallback_hit_test
    Booleano; indica se deve tentar o acerto por amostragem da tela quando a lista comum está vazia.
  • hit_test_spacing
    Número; espaçamento da amostragem da tela, em coordenadas lógicas. O padrão é 40.

Opções de exclusão de atributos​

Disponíveis a partir de 20261115. Apenas para snapshot() e list_text_elements(). Todas são booleanas, têm valor padrão false e também se aplicam aos elementos filhos. Quando esses estados não forem necessários, ativar as opções de exclusão pode reduzir o custo das consultas e acelerar a captura de snapshots.

  • exclude_visibility
    Quando true, pula as consultas de visibilidade e omite isVisible.
  • exclude_map
    Quando true, pula a verificação do atributo de mapa e omite isMap; os elementos de mapa são mantidos.
  • exclude_hit_state
    Quando true, pula as verificações de hit no ponto central e omite canHit, hitVerified, hitTestPoint e hitTestPointLogical. Não pode ser combinada com include_hit_state = true.

O escopo dos elementos, o texto, as coordenadas e as regras de busca complementar de elementos de hit_test / fallback_hit_test permanecem iguais. Não exclua um campo de estado se precisar filtrar por ele.

Opções de ação​

  • point
    Tabela; especifica o ponto de coordenadas usado para rolagem ou acerto, por exemplo { x = 200, y = 700 }, em pixels físicos.
  • x / y
    Inteiro; equivalente a point, pode ser colocado diretamente na tabela de opções.
  • steps
    Número; parâmetro de passo para operações de rolagem, aumento ou redução. O efeito exato depende do controle de destino.

Descrição​

list_text_elements() é mais conservador por padrão para compatibilidade com scripts antigos. find(), find_all(), snapshot() e as interfaces de ação são mais adequados para uso direto em scripts novos. hit_test pode retornar elementos mais próximos da interface atual do nível superior, mas tem custo maior; recomenda-se usá-lo somente quando uma consulta comum não encontrar o elemento.